iT邦幫忙

2025 iThome 鐵人賽

DAY 1
1
Software Development

spring boot 3 學習筆記系列 第 1

Day01 - Spring Boot 3 開發環境建置(1) - OpenJDK 與 Apache Maven 下載並安裝 (適用於 Windows)

  • 分享至 

  • xImage
  •  

OpenJDK 下載並安裝

在開發 Spring Boot 應用程式時,JDK(Java Development Kit)是不可或缺的工具,負責編譯與執行 Java 程式。目前市場上有多種 OpenJDK 發行版本,它們在相容性與穩定性上相差不大,因此您可以根據需求選擇適合的版本。

目前較常見的 OpenJDK 長期支援(LTS)版本包括 8、11、17 和 21。選擇 LTS 版本可以確保較長時間的更新與技術支援。

本次學習將選擇 Eclipse Adoptium 版本來安裝,Eclipse Adoptium 提供基於 OpenJDK 的免費 Java SE 版本,適用於各種作業系統與架構,並定期更新以確保穩定性與安全性。因此本節將說明如何下載並安裝最新的 OpenJDK 21-LST。

下載 OpenJDK

  1. 前往 Eclipse Adoptium 官方下載頁面

開啟 Eclipse Adoptium 下載頁面

  1. 選擇適當的安裝相關參數

https://ithelp.ithome.com.tw/upload/images/20250821/20171829KZHYdTAWSm.png

(1) Version(版本):選擇所需的 Java 版本,例如 21 - LTS(長期支援版)。
(2) Operating System(作業系統):選擇您的作業系統,例如 Windows、macOS 或 Linux。
(3) Architecture(架構):選擇適用的架構,例如 x64(大多數現代電腦適用)。

  1. 下載適當的安裝檔案

您可以選擇以下兩種格式進行下載:

  • .msi 格式:Windows 安裝程式,提供直覺化的安裝步驟,適合一般使用者。
  • .zip 格式:免安裝版本,適合進階使用者,可手動設定安裝路徑與環境變數。

本次學習將選擇 .msi 格式並點擊下載按鈕。

安裝 OpenJDK

  1. 執行安裝程式

    下載完成後,雙擊 .msi 檔案,並按照安裝精靈指示進行:

    https://ithelp.ithome.com.tw/upload/images/20250821/20171829NKmWKwqcQP.png

    (1) 點擊 Next 繼續。

    https://ithelp.ithome.com.tw/upload/images/20250821/20171829I0cKi1UNYY.png

    (2) 勾選[我接受授權合約中的條款(I accept the terms in the License Agreement)],點擊 Next 繼續。

    https://ithelp.ithome.com.tw/upload/images/20250821/201718295bpEI1bHmn.png

    (3) 在 Installation Scope 視窗中,點擊 Install for all users of this machine 核取方塊(Checkbox) ,點擊 Next 繼續。

    https://ithelp.ithome.com.tw/upload/images/20250821/20171829oBRTmmn7W2.png

    (4) 在安裝路徑的部分,預設為 C:\Program Files\Eclipse Adoptium\jdk-21.0.8_9-hotspot\

    https://ithelp.ithome.com.tw/upload/images/20250821/20171829Mxksii3kS6.png

    若您希望變更安裝路徑,可點擊 Browse 來選擇不同的資料夾。這裡會變更為 C:\JDK\EclipseAdoptium\jdk-21.0.8_9-hotspot\,然後點擊 Next

    https://ithelp.ithome.com.tw/upload/images/20250821/20171829XaWi5wAAY5.png

    (5) 確認安裝設定後,點擊 Install

    https://ithelp.ithome.com.tw/upload/images/20250821/20171829mHzaxvAwvl.png

    (6) 開始安裝。

    https://ithelp.ithome.com.tw/upload/images/20250821/20171829uLxkASNJNT.png

    (7) 安裝完成後,點擊 Finish 結束安裝程式。

    https://ithelp.ithome.com.tw/upload/images/20250821/20171829qwgrNn2DQU.png

  2. 設定環境變數

    (1) 設定 JAVA_HOME 環境變數

    • 按下鍵盤 windows 鍵 + R,開啟 執行 對話框,輸入 sysdm.cpl,並點選 確定 開啟系統內容視窗。

      https://ithelp.ithome.com.tw/upload/images/20250821/20171829fpHK17bAcn.png

    • 系統內容 視窗中,點擊 進階 頁籤 => 點擊 環境變數

      https://ithelp.ithome.com.tw/upload/images/20250821/20171829qFOyTgJOmn.png

    • 環境變數 視窗中,系統變數 區域,點擊 新增

      https://ithelp.ithome.com.tw/upload/images/20250821/20171829cl66BCF4oe.png

    • 新增系統變數 視窗中,變數名稱 欄位中輸入 JAVA_HOME

      https://ithelp.ithome.com.tw/upload/images/20250821/20171829ePL7J24h7L.png

    • 新增系統變數 視窗中,變數值 欄位中輸入剛剛所安裝好的 JDK 路徑位置。最簡單的方法就是直接開啟 JDK 所安裝在的資料夾,然後將其路徑位置複製,及貼上至變數值的欄位中。

      https://ithelp.ithome.com.tw/upload/images/20250821/20171829BEr9o01FV7.png

    • 完成變數名稱變數值的欄位輸入完成,點選 確定 儲存。

      https://ithelp.ithome.com.tw/upload/images/20250821/20171829hvyrOWVwWd.png

    • 如下圖所示可以看到已新增了一筆 JAVA_HOME 變數。

      https://ithelp.ithome.com.tw/upload/images/20250821/20171829GzGXLqk8VA.png

    (2) 設定 PATH 變數

    • 系統變數 區域,選擇 Path 變數並點擊 編輯

      https://ithelp.ithome.com.tw/upload/images/20250821/201718298HmRw4WL8q.png

    • 編輯環境變數 視窗中,點擊剛剛安裝所安裝 JDK 路徑的位置資料 C:\JDK\EclipseAdoptium\jdk-21.0.8_9-hotspot\,點擊 編輯,將剛剛安裝 JDK 路徑修改成 %JAVA_HOME%\bin,完成後點選 確定 儲存你的變更。

      https://ithelp.ithome.com.tw/upload/images/20250821/20171829DCqcaQz6kr.png

      https://ithelp.ithome.com.tw/upload/images/20250821/20171829sI1xIJ6jli.png

    • Path 變數設定完成,接下來點擊 確定 保存變更。

      https://ithelp.ithome.com.tw/upload/images/20250821/20171829Ge0jPx8Bhe.png

  3. 驗證安裝是否成功

    (1) 開啟命令提示字元 (CMD)

    • Win + R,輸入 cmd,然後按 Enter

      https://ithelp.ithome.com.tw/upload/images/20250821/20171829PUxceyh1HQ.png

    (2) 檢查 Java 版本

    在命令提示字元輸入以下指令:

    java -version
    

    若安裝成功,應會顯示類似以下的資訊:

    openjdk version "21.0.8" 2025-07-15 LTS
    OpenJDK Runtime Environment Temurin-21.0.8+9 (build 21.0.8+9-LTS)
    OpenJDK 64-Bit Server VM Temurin-21.0.8+9 (build 21.0.8+9-LTS, mixed mode, sharing)
    

    https://ithelp.ithome.com.tw/upload/images/20250821/20171829N6DwNfqVjZ.png

    這表示 OpenJDK 已成功安裝並可使用。

Apache Maven 下載並安裝

Apache Maven 是一款流行的建構與專案管理工具,主要用於 Java 專案。它基於 POM(Project Object Model)來管理專案的建置、依賴管理與生命週期。

Maven 的設計目標是簡化專案管理,使開發者可以專注於程式碼開發,而不是手動處理建置與依賴問題。

為什麼需要安裝 Maven?

對於 Java 開發者來說,Maven 提供了一套標準化的方式來管理專案,以下是幾個主要的好處:

  1. 自動化建置:Maven 可以自動執行編譯、測試、打包與部署,減少手動操作的繁瑣性。
  2. 依賴管理:Maven 透過中央倉庫(Maven Central Repository)來管理專案的外部函式庫,開發者不需要手動下載與配置 JAR 檔案。
  3. 一致性:使用 Maven 可以確保不同開發者的環境配置一致,減少「在我的機器上可以運行」的問題。
  4. 專案管理:Maven 提供了一套標準化的專案結構與生命週期管理,適用於不同規模的應用程式。
  5. 擴充性:Maven 支援各種外掛(Plugins),可以用來整合測試工具、部署工具與報表生成工具。

如何安裝 Maven?

安裝 Maven 的過程相當簡單,以下是基本步驟:

  1. 下載 Maven

    • 前往 Apache Maven 官方網站 下載最新版本。本次學習下載 apache-maven-3.9.11-bin.zip 檔案。

      https://ithelp.ithome.com.tw/upload/images/20250821/20171829n2RxXMR743.png

    • 選擇二進位檔案(Binary archive)並解壓縮到合適的目錄,例如 C:\apache-maven

      https://ithelp.ithome.com.tw/upload/images/20250821/20171829jZAgpncRyx.png

  2. 設定環境變數

    (1) 設定 MAVEN_HOME 環境變數

    • 按下鍵盤 windows 鍵 + R,開啟 執行 對話框,輸入 sysdm.cpl,並點選 確定 開啟系統內容視窗。

      https://ithelp.ithome.com.tw/upload/images/20250821/20171829kUa62q5Rvy.png

    • 系統內容 視窗中,點擊 進階 頁籤 → 點擊 環境變數

      https://ithelp.ithome.com.tw/upload/images/20250821/20171829KeTkoDnAsK.png

    • 環境變數 視窗中,系統變數 區域,點擊 新增

      https://ithelp.ithome.com.tw/upload/images/20250821/20171829gfGifDbnxn.png

    • 新增系統變數 視窗中,變數名稱 欄位中輸入 MAVEN_HOME

      https://ithelp.ithome.com.tw/upload/images/20250821/20171829LFcIFs0RV2.png

    • 新增系統變數 視窗中,變數值 欄位中輸入剛剛 Maven 解壓縮後的目錄路徑。(C:\apache-maven\apache-maven-3.9.11)

      https://ithelp.ithome.com.tw/upload/images/20250821/20171829DVk8I1Bo5c.png

    • 完成變數名稱變數值的欄位輸入完成,點選 確定 儲存。

      https://ithelp.ithome.com.tw/upload/images/20250821/2017182999hoC8UoSD.png

    • 如下圖所示可以看到已新增了一筆 MAVEN_HOME 變數。

      https://ithelp.ithome.com.tw/upload/images/20250821/20171829gOiaF9nEcF.png

    (2) 設定 PATH 變數

    • 系統變數 區域,選擇 Path 變數並點擊 編輯

      https://ithelp.ithome.com.tw/upload/images/20250821/20171829HoUQGXjglo.png

    • 編輯環境變數 視窗中,將 Maven 的 bin 目錄新增到 PATH 環境變數中,如:%MAVEN_HOME%\bin

      https://ithelp.ithome.com.tw/upload/images/20250821/201718290C1EOxoSbX.png

    • Path 變數設定完成,接下來點擊 確定 保存變更。

      https://ithelp.ithome.com.tw/upload/images/20250821/20171829YH84lXhAiV.png

  3. 驗證安裝是否成功

    • Win + R,輸入 cmd,然後按 Enter

      https://ithelp.ithome.com.tw/upload/images/20250821/201718299YFJI5R2Ui.png

    • 開啟命令提示字元(CMD 或 Terminal),輸入:

      mvn -version
      
    • 如果成功顯示 Maven 版本與 Java 版本,代表安裝完成。

      https://ithelp.ithome.com.tw/upload/images/20250821/201718291MOmHNEPvK.png

Maven 的基本概念

Maven 主要依賴 pom.xml (Project Object Model)檔案來管理專案,這是一個 XML 檔案,包含專案資訊、依賴關係與建置配置。例如:

<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example</groupId>
    <artifactId>demo</artifactId>
    <version>1.0.0</version>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
            <version>3.5.4</version>
        </dependency>
    </dependencies>
</project>

上述 pom.xml 定義了一個基本的 Spring Boot 專案,並自動下載 spring-boot-starter-web 依賴。

常用 Maven 指令

安裝 Maven 之後,可以使用以下指令來管理專案:

  • 建置專案(編譯、測試、打包)

    mvn clean package
    
  • 執行單元測試

    mvn test
    
  • 下載與更新依賴

    mvn dependency:resolve
    
  • 啟動 Spring Boot 應用

    mvn spring-boot:run
    

下一篇
Day02 - Spring Boot 3 開發環境建置(2) - IntelliJ IDEA Community 開發工具下載並安裝 (適用於 Windows)
系列文
spring boot 3 學習筆記15
圖片
  熱門推薦
圖片
{{ item.channelVendor }} | {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言